
<!DOCTYPE html>
<!--

    Copyright (c) 2017, 2019 Oracle and/or its affiliates. All rights reserved.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Public License v. 2.0, which is available at
    http://www.eclipse.org/legal/epl-2.0.

    This Source Code may also be made available under the following Secondary
    Licenses when the conditions for such availability set forth in the
    Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
    version 2 with the GNU Classpath Exception, which is available at
    https://www.gnu.org/software/classpath/license.html.

    SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

-->
<!-- Portions Copyright [2019] [Payara Foundation and/or its affiliates] -->
<html lang="en">
  <head>
    <meta charset="utf-8"/>
    <title>create-node-dcom</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <link href="css/style.css" rel="stylesheet">
    <script src="https://use.fontawesome.com/96c4d89611.js"></script>
  </head>
  <body>
<table id="doc-title" cellspacing="0" cellpadding="0">
  <tr>
  <td align="left" valign="top">
  <b>create-node-dcom</b><br />
  </td>
  </tr>
</table>
<hr />

<table width="90%" id="top-nav" cellspacing="0" cellpadding="0">
	<colgroup>
		<col width="12%"/>
		<col width="12%"/>
		<col width="*"/>
	</colgroup>
	<tr>
		<td align="left">
		<a href="create-node-config.html">
			<span class="vector-font"><i class="fa fa-arrow-circle-left" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Previous</span>
		</a>
		</td>

		<td align="left">
		<a href="create-node-ssh.html">
			<span class=" vector-font"><i class="fa fa-arrow-circle-right vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Next</span>
		</a>
		</td>

		<td align="right">
		<a href="toc.html">
			<span class=" vector-font"><i class="fa fa-list vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Contents</span>
		</a>
		</td>
	</tr>
</table>


<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p><a id="create-node-dcom-1"></a><a id="GSRFM510"></a><a id="create-node-dcom"></a></p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_create_node_dcom">create-node-dcom</h2>
<div class="sectionbody">
<div class="paragraph">
<p>creates a node that is enabled for communication over DCOM</p>
</div>
<div id="sthref453" class="paragraph">
<p>Synopsis</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin [asadmin-options] create-node-dcom [--help]
--nodehost node-host
[--installdir as-install-parent] [--nodedir node-dir]
[--windowsuser windows-user] [--windowsdomain windows-domain]
[--force={false|true}]
[--install={false|true}] [--archive archive]
node-name</code></pre>
</div>
</div>
<div id="sthref454" class="paragraph">
<p>Description</p>
</div>
<div class="paragraph">
<p>The <code>create-node-dcom</code> subcommand creates a node that is enabled for
communication over the Distributed Component Object Model (DCOM) remote
protocol. The DCOM protocol is available only on Windows systems.</p>
</div>
<div class="paragraph">
<p>A node represents a host on which the \{product---name} software is
installed. A node must exist for every host on which \{product---name}
instances reside.</p>
</div>
<div class="paragraph">
<p>In a DCOM-enabled network, the domain administration server (DAS)
contacts a node&#8217;s host through the DCOM connector to manage
\{product---name} instances that reside on the node. DCOM is used only
for communications between hosts. DCOM is never used for communications
within a single host.</p>
</div>
<div class="paragraph">
<p>By default, the subcommand fails and the node is not created if the DAS
cannot contact the node&#8217;s host through DCOM. To force the node to be
created in the DAS configuration even if the host cannot be contacted
through DCOM, set the <code>--force</code> option to <code>true</code>.</p>
</div>
<div class="paragraph">
<p>The <code>create-node-dcom</code> subcommand cannot create a node that represents
the local host, that is, the host on which the subcommand is run. The
subcommand fails regardless of how the local host is specified, for
example, by using the keyword <code>localhost</code>, the Internet Protocol (IP)
address of the host, or the host name.</p>
</div>
<div class="paragraph">
<p>This subcommand is supported in remote mode only.</p>
</div>
<div id="sthref455" class="paragraph">
<p>Options</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">asadmin-options</dt>
<dd>
<p>Options for the <code>asadmin</code> utility. For information about these
options, see the <a href="asadmin.html#asadmin-1m"><code>asadmin</code>(1M)</a> help page.</p>
</dd>
<dt class="hdlist1"><code>--help</code></dt>
<dt class="hdlist1"><code>-?</code></dt>
<dd>
<p>Displays the help text for the subcommand.</p>
</dd>
<dt class="hdlist1"><code>--nodehost</code></dt>
<dd>
<p>The name of the host that the node represents. The name of the host
must be specified. Otherwise, an error occurs.</p>
</dd>
<dt class="hdlist1"><code>--installdir</code></dt>
<dd>
<p>The full path to the parent of the base installation directory of the
\{product---name} software on the host, for example, <code>C:\glassfish3</code>.
The default is the parent of the default base installation directory
of the \{product---name} software for the DAS. This default is useful
only if \{product---name} is installed in the same location on all
hosts.</p>
</dd>
<dt class="hdlist1"><code>--nodedir</code></dt>
<dd>
<p>The path to the directory that is to contain \{product---name}
instances that are created on the node. The default is
as-install`\nodes`, where as-install is the base installation
directory of the \{product---name} software on the host. If a relative
path is specified, the path is relative to the as-install directory.</p>
</dd>
<dt class="hdlist1"><code>--windowsuser</code></dt>
<dt class="hdlist1"><code>-w</code></dt>
<dd>
<p>The user on this node&#8217;s host that is to run the process for connecting
to the host through DCOM. The default is the user that is running the
DAS process. If the <code>--nodehost</code> option is set to <code>localhost-`domain,
the `--windowsuser</code> option is ignored</p>
</dd>
<dt class="hdlist1"><code>--windowsdomain</code></dt>
<dt class="hdlist1"><code>-d</code></dt>
<dd>
<p>The name of the Windows domain that contains the user that the
<code>--windowsuser</code> option specifies. The default is the name of the host
on which the subcommand is run.</p>
</dd>
<dt class="hdlist1"><code>--force</code></dt>
<dd>
<p>Specifies whether the node is created in the DAS configuration even if
validation of the node&#8217;s parameters fails. To validate a node&#8217;s
parameters, the DAS must be able to contact the node&#8217;s host through
DCOM. Possible values are as follows:<br></p>
<div class="dlist">
<dl>
<dt class="hdlist1"><code>false</code></dt>
<dd>
<p>The node is not created if validation of the node&#8217;s parameters fails
(default).</p>
</dd>
<dt class="hdlist1"><code>true</code></dt>
<dd>
<p>The node is created even if validation of the node&#8217;s parameters
fails.</p>
</dd>
</dl>
</div>
</dd>
<dt class="hdlist1"><code>--install</code></dt>
<dd>
<p>Specifies whether the subcommand shall install the \{product---name}
software on the host that the node represents.<br>
Possible values are as follows:<br></p>
<div class="dlist">
<dl>
<dt class="hdlist1"><code>false</code></dt>
<dd>
<p>The subcommand shall not install the \{product---name} software on
the host (default).</p>
</dd>
<dt class="hdlist1"><code>true</code></dt>
<dd>
<p>The subcommand shall install the \{product---name} software on the
host.</p>
</dd>
</dl>
</div>
</dd>
<dt class="hdlist1"><code>--archive</code></dt>
<dd>
<p>The absolute path to the archive file of the \{product---name}
software that is to be installed. If this option is omitted and the
<code>--install</code> is <code>true</code>, the subcommand creates a ZIP archive of the
\{product---name} software from the installation where this subcommand
is run. The archive does not contain the <code>domains</code> directory or the
<code>nodes</code> directory.</p>
</dd>
</dl>
</div>
<div id="sthref456" class="paragraph">
<p>Operands</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">node-name</dt>
<dd>
<p>The name of the node.<br>
The name must meet the following requirements:<br></p>
<div class="ulist">
<ul>
<li>
<p>The name may contain only ASCII characters.</p>
</li>
<li>
<p>The name must start with a letter, a number, or an underscore.</p>
</li>
<li>
<p>The name may contain only the following characters:</p>
<div class="ulist">
<ul>
<li>
<p>Lowercase letters</p>
</li>
<li>
<p>Uppercase letters</p>
</li>
<li>
<p>Numbers</p>
</li>
<li>
<p>Hyphen</p>
</li>
<li>
<p>Period</p>
</li>
<li>
<p>Underscore</p>
</li>
</ul>
</div>
</li>
<li>
<p>The name must be unique in the domain and must not be the name of
another node, a cluster, a named configuration, or a \{product---name}
instance.</p>
</li>
<li>
<p>The name must not be <code>domain</code>, <code>server</code>, or any other keyword that
is reserved by \{product---name}.</p>
</li>
</ul>
</div>
</dd>
</dl>
</div>
<div id="sthref457" class="paragraph">
<p>Examples</p>
</div>
<div class="paragraph">
<p><a id="GSRFM511"></a><a id="sthref458"></a></p>
</div>
<div class="paragraph">
<p>Example 1   Creating a Node</p>
</div>
<div class="paragraph">
<p>This example creates the node <code>wpmdl1</code> for the host
<code>wpmdl1.example.com</code>. By default, the parent of the base installation
directory of the \{product---name} software is <code>C:\glassfish3</code>.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin&gt; create-node-dcom
--nodehost wpmdl1.example.com wpmdl1
Command create-node-dcom executed successfully.</code></pre>
</div>
</div>
<div class="paragraph">
<p><a id="GSRFM829"></a><a id="sthref459"></a></p>
</div>
<div class="paragraph">
<p>Example 2   Creating a Node With a Specific Installation Directory</p>
</div>
<div class="paragraph">
<p>This example creates the node <code>wyml1</code> for the host <code>wyml1.example.com</code>.
The parent of the base installation directory of the \{product---name}
software on this host is <code>C:\middleware\glassfish3</code>.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin&gt; create-node-dcom --installdir C:\middleware\glassfish3
--nodehost wyml1.example.com wyml1
Command create-node-dcom executed successfully.</code></pre>
</div>
</div>
<div class="paragraph">
<p><a id="GSRFM512"></a><a id="sthref460"></a></p>
</div>
<div class="paragraph">
<p>Example 3   Forcing the Creation of a Node</p>
</div>
<div class="paragraph">
<p>This example forces the creation of node <code>xkyd</code> for the host
<code>xkyd.example.com</code>. The node is created despite the failure of the DAS
to contact the host <code>xkyd.example.com</code> to validate the node&#8217;s
parameters.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin&gt; create-node-dcom --force --nodehost xkyd.example.com xkyd
Warning: some parameters appear to be invalid.
com.sun.enterprise.universal.process.WindowsException: Connection in error
Continuing with node creation due to use of --force.
Command create-node-dcom executed successfully.</code></pre>
</div>
</div>
<div id="sthref461" class="paragraph">
<p>Exit Status</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">0</dt>
<dd>
<p>command executed successfully</p>
</dd>
<dt class="hdlist1">1</dt>
<dd>
<p>error in executing the command</p>
</dd>
</dl>
</div>
<div id="sthref462" class="paragraph">
<p>See Also</p>
</div>
<div class="paragraph">
<p><a href="asadmin.html#asadmin-1m"><code>asadmin</code>(1M)</a></p>
</div>
<div class="paragraph">
<p><a href="create-node-config.html#create-node-config-1"><code>create-node-config</code>(1)</a>,
<a href="create-node-ssh.html#create-node-ssh-1"><code>create-node-ssh</code>(1)</a>,
<a href="delete-node-dcom.html#delete-node-dcom-1"><code>delete-node-dcom</code>(1)</a>,
<a href="install-node-dcom.html#install-node-dcom-1"><code>install-node-dcom</code>(1)</a>,
<a href="list-nodes.html#list-nodes-1"><code>list-nodes</code>(1)</a>,
<a href="uninstall-node-dcom.html#uninstall-node-dcom-1"><code>uninstall-node-dcom</code>(1)</a>,
<a href="update-node-ssh.html#update-node-dcom-1"><code>update-node-dcom</code>(1)</a></p>
</div>
</div>
</div>

<hr />

<table width="90%" id="bottom-nav" cellspacing="0" cellpadding="0">
	<colgroup>
		<col width="12%"/>
		<col width="12%"/>
		<col width="*"/>
	</colgroup>
	<tr>		
		<td align="left">
		<a href="create-node-config.html">
			<span class=" vector-font"><i class="fa fa-arrow-circle-left" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Previous</span>
		</a>
		</td>

		<td align="left">
		<a href="create-node-ssh.html">
			<span class="vector-font"><i class="fa fa-arrow-circle-right vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Next</span>
		</a>
		</td>

		<td align="right">
		<a href="toc.html">
			<span class="vector-font"><i class="fa fa-list vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Contents</span>
		</a>
		</td>
	</tr>
</table>

<span id="copyright">
        <img src="/resource/reference/img/eclipse_foundation_logo_tiny.png" height="20px" alt="Eclipse Foundation Logo" align="top"/>&nbsp;            
        <span >Copyright&nbsp;&copy;&nbsp;2019,&nbsp;Oracle&nbsp;and/or&nbsp;its&nbsp;affiliates.&nbsp;All&nbsp;rights&nbsp;reserved.</span>
</span>

</body>
</html>
